ExportHELMAC V2 - Export des articles Clyo vers les balances Helmac
===================================================================

A quoi ca sert
--------------
Genere le fichier Helmac.txt a partir de la base Clyo, pour l'import dans
le logiciel de la balance (HFT). Une ligne de 77 caracteres par article.

Nouveautes de la V2 (30/09/2026) par rapport a l'exe d'origine (V1)
-------------------------------------------------------------------
- Seuls les articles AU POIDS sont exportes (case "balance" cochee dans
  l'article Clyo, chp_balance = 1). Les articles a la piece ne sortent plus.
- Le numero de PLU (4 premiers caracteres) est la POSITION de l'article dans
  Clyo, et plus son id. Position 1 -> PLU 0001.
- Le fichier est trie par position (tri numerique : 1, 2, 3... 10, 11).
- Si plusieurs articles au poids ont la meme position, un message d'alerte
  s'affiche a la fin de l'export avec la liste des articles concernes
  (designation, id, famille / sous-famille). Le fichier est quand meme genere,
  il suffit de cliquer OK. Sur la balance, ces articles auraient le meme PLU.
- Le fichier n'a plus de BOM (3 octets EF BB BF) en tete. L'ancien exe en
  ecrivait un.

Regle de gestion a respecter dans Clyo
--------------------------------------
Tout article au poids doit avoir une position, unique, entre 1 et 9999.
- Position vide ou 0  -> PLU 0000 (et signale comme doublon).
- Position > 9999     -> seuls les 4 derniers chiffres sont gardes.

Installation sur un poste
-------------------------
1. Copier ExportHELMAC.exe dans C:\Clyo (il a besoin de ClyoDBConnection.dll,
   MySql.Data.dll et configuration.xml qui s'y trouvent).
2. Si Windows affiche "L'editeur n'a pas pu etre verifie" : clic droit sur
   l'exe > Proprietes > cocher "Debloquer" > OK. A faire une seule fois.
3. Mettre a jour le raccourci HFT pour qu'il pointe sur ce nouvel exe.
   Le champ "Demarrer dans" doit rester sur C:\Clyo.
4. L'exe n'a pas d'interface : il s'ouvre, ecrit C:\Clyo\Helmac.txt
   (ecrase a chaque lancement) et se referme. Seul le message de doublons
   peut apparaitre.

Format d'une ligne (77 caracteres)
----------------------------------
Pos  Long  Contenu
  1    4   N° PLU = position de l'article, complete par des zeros
  5   20   Designation courte (tronquee / completee par des espaces)
 25   20   Designation longue
 45    1   P (au poids). C = a la piece, ne sort plus depuis la V2
 46    6   Prix en centimes (8,50 EUR -> 000850)
 52    2   N° de famille
 54    4   Tare
 58    6   Code article = id Clyo (des_coresp)
 64    1   Code TVA (1er chiffre de tva1)
 65   13   Code EAN13 (zeros si absent)

Exemple :
0001BRESAOLA                                P00850014000000173210000000001732

Encodage : UTF-8 sans BOM. Les accents occupent 2 octets, eviter les accents
dans les designations si la balance compte en octets.

En cas de probleme
------------------
- Aucun fichier genere : la base n'est pas joignable ou la requete a echoue.
  L'exe ne montre pas l'erreur (comportement herite de l'original). Verifier
  que Clyo fonctionne sur le poste et que l'exe est bien lance depuis C:\Clyo.
- Fichier vide : aucun article au poids actif (chp_balance=1, deleted=0,
  chp_cat<>3).

Fichiers du dossier
-------------------
ExportHELMAC.exe  l'outil (a deployer)
ExportHELMAC.pdb  symboles de debug (facultatif)
README.txt        ce fichier

Code source C# (.NET Framework 4.8, x86) : ExportHELMAC.cs dans le dossier
"ExportHELMAC v1.1 (articles au poids, PLU=position)" a cote. Pour recompiler
sans Visual Studio, depuis un dossier contenant ExportHELMAC.cs et
ClyoDBConnection.dll :
  C:\Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe -platform:x86
    -target:winexe -r:ClyoDBConnection.dll -r:System.Data.dll
    -r:System.Windows.Forms.dll -r:System.Drawing.dll -r:System.Core.dll
    -out:ExportHELMAC.exe ExportHELMAC.cs

L'exe d'origine (V1, 13/05/2026) est conserve dans le zip du dossier parent.
